Node / ReticulumProjects / MeshChatX.git / files / docs / en / platform-guides / android-termux.md

Displaying Raw • View rendered • Download

Tc9d1d9# Android with Termux

MeshChatX runs on Android through [Tff7b72Termux](Te6edf3https://termux.dev/). Release wheels ship the Python backend and built web UI, so you do not need Node on the phone for a normal install.

Tc9d1d9## Install from wheel

The wheel bundles server code and frontend assets.

Tc9d1d9### System packages

Ta5d6ff```

pkg upgrade

pkg install python

pkg install rust

pkg install binutils

pkg install build-essential

```

Tff7b72> Note: Python 3.11 or higher is required. Check with `python --version`.

Tc9d1d9### Wheel install

Download the latest wheel from the [Tff7b72releases page](Te6edf3https://github.com/Quad4-Software/MeshChatX/releases), then:

Ta5d6ff```

pip install reticulum_meshchatx-*-py3-none-any.whl

```

The wheel pulls Python dependencies automatically. Building Ta5d6ff`cryptography` can take several minutes on Android.

Tc9d1d9### Run

Ta5d6ff```

meshchatx

```

(Ta5d6ff`meshchat` is a compatibility alias for the same entry point.)

Open Ta5d6ff`http://localhost:8000` in the Android browser.

Tc9d1d9## Install from source

Use this path for development or when no wheel fits your setup.

Tc9d1d9### System packages

Ta5d6ff```

pkg upgrade

pkg install git

pkg install nodejs-lts

pkg install python

pkg install rust

pkg install binutils

pkg install build-essential

```

Tc9d1d9### pnpm

Ta5d6ff```

corepack enable

corepack prepare pnpm@latest --activate

```

Tc9d1d9### Clone and build

Ta5d6ff```

git clone https://github.com/Quad4-Software/MeshChatX.git

cd MeshChatX

pip install uv

uv sync --group dev

pnpm install

pnpm run build-frontend

uv build --wheel

pip install dist/*.whl

```

Tc9d1d9### Run

Ta5d6ff```

meshchatx

```

(Ta5d6ff`meshchat` is a compatibility alias for the same entry point.)

Tc9d1d9## Configuration notes

Tff7b72> Note: The default `AutoInterface` may not work on your Android device. Configure another interface such as `TCPClientInterface` in the settings.